今天是鐵人賽 Day8,目標是建立 React 前端專案,並整合 Tailwind CSS,讓我們可以用簡單的 class 快速做出漂亮的 UI。這是前端開發的第一步,接下來會串接後端 API 來顯示商品資料。
1️⃣ 建立 React 專案
使用 Vite 快速建立專案:
npm create vite@latest frontend
cd frontend
npm install
專案建立後,我們就可以進行前端開發了。

2️⃣ 安裝 Tailwind CSS
安裝 Tailwind 與相關套件:npm install -D tailwindcss postcss autoprefixer
初始化 Tailwind 設定檔:npx tailwindcss init -p
在 tailwind.config.js 中設定掃描路徑:content: ["./index.html", "./src/**/*.{js,jsx,ts,tsx}"]
在 src/index.css 引入 Tailwind 指令:
@tailwind base;
@tailwind components;
@tailwind utilities;
在 main.jsx 引入 index.css:import './index.css';
3️⃣ 測試 Tailwind CSS 是否生效
在 App.jsx 或 main.jsx 加入測試文字:
<h1 className="text-3xl font-bold text-blue-600">
Hello Tailwind!
</h1>
啟動開發伺服器:npm run dev
打開瀏覽器,看到藍色大字「Hello Tailwind!」就代表成功
🐛 遇到的問題
Tailwind CSS 無法正常啟動
一開始執行 npx tailwindcss init -p 會跳出 npm error could not determine executable to run
原因是 版本衝突 或 Windows PowerShell 的 PATH 設定
解法:確認 Node 與 npm 版本,刪除 node_modules + package-lock.json,重新安裝,再用 .bin 路徑執行 tailwind(例如:.\node_modules.bin\tailwindcss.cmd init -p)
沒有看到 tailwindcss.cmd
原因:安裝過程可能中斷或依賴版本不一致
解法:確定 package.json 裡有 "tailwindcss",然後完整執行 npm install
版本問題卡超久
React / Vite / Tailwind 的相容性要搭配正確版本
建議在建立專案前先查官方文件,避免最新套件衝突
💡 Day8 收穫
我在執行第二步驟時npx tailwindcss init -p
出現錯誤訊息:'tailwind' 不是內部或外部命令、可執行的程式或批次檔。
經查發現npm list tailwindcss
React在建立的時候已經內建建立最新的V4版本,
├─┬ react-scripts@5.0.1
│ └── tailwindcss@3.4.18
└── tailwindcss@4.1.17
然後V4版本已經不支援「tailwind.config.js 文件設定檔」。
※備註:tailwindcss官網,2025/1/22的更版有公告已經棄用「tailwind.config.js 文件設定檔」。
如果要跟著作者的作法,要強制把tailwindcss控制在V4版本以下。npm install -D tailwindcss@3.4.17 postcss autoprefixer